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ABOUT THIS CHAPTER 


Warning: This chapter has not been updated to reflect changes and improvements 


This 
Slot 


that are available on systems using 32-Bit QuickDraw. For further 
information on 32-Bit QuickDraw, please refer to the 32-Bit QuickDraw 
documentation (available on "Phil & Dave's Excellent CD: The Release 
Version). 


chapter describes the Slot Manager section of the Macintosh II ROM. The 
Manager contains routines that let your program identify cards plugged into 


NuBus slots in the Macintosh II and communicate with the firmware on each card. 


Note: 


The Macintosh SE computer also has slots, but they work differently. 
For an explanation of Macintosh SE slots, see the book "Designing Cards 
and Drivers for Macintosh II and Macintosh SE." 


Reader's guide: You need the information in this chapter only if you are 


writing an application, driver, or operating system that 
must access a slot card directly. Otherwise, the standard 
Macintosh Toolbox and Operating System routines normally 
take care of all slot card management, making the Slot 
Manager transparent to most applications. 


The Slot Manager routines described in this chapter are divided into three 
sections: 


e 


Note: 


The section "Principal Slot Manager Routines" describes routines that you 
might need if you are writing an application or a driver. 

The section "Specialized Slot Manager Routines" describes routines that 
you might need if you are writing a driver. 

The section "Advanced Slot Manager Routines" describes routines that are 
normally used only by the operating system. This section is included for 
completeness of documentation. 


When accessing NuBus cards directly, it is important that you use the 
standard Slot Manager routines. If you try to bypass them, your 
application may conflict with other applications and probably will not 
work in future Apple computers. 


Before trying to use the information in this chapter, you should already be 


famil 
be fa 


e 


iar with the Device Manager. If you are writing a driver, you should also 
miliar with 


the information in the book "Designing Cards and Drivers for Macintosh II 
and Macintosh SE" 


the architecture and mode of operation of the specific card or cards your 
driver will access 
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SLOT CARD FIRMWARE 


Most of the routines described in this chapter let you access data or code 
structures residing in the firmware of all NuBus plug-in cards. These 
structures are described in detail in the book "Designing Cards and Drivers for 
Macintosh II and Macintosh SE." They have certain uniform features that create 
a standard interface to the Slot Manager. The principal card firmware 
structures are the following: 


¢ A format block, containing format and identification information for the 
card's firmware and an offset to its sResource directory 

e An sResource directory, containing an identification number and offset 
for each sResource list in the firmware 

e A Board sResource list, containing information about the slot card itself 

e One or more other sResource lists, each of which contains information 
about a single sResource in the card's firmware 


Don't confuse sResources on plug-in cards with standard Macintosh resources; 
they are different, although related conceptually. Every sResource has a type 
and a name. It may also have an icon and driver code in firmware, and may 
define a region of system memory allocated to the card it is in. Such 
sResources are treated like devices. Some sResources, however, may contain only 
data—for example, special fonts. You must understand the specific nature of an 
sResource before trying to access it with the Slot Manager. 


The physical location of a slot card's firmware is called its declaration ROM. 
The Slot Manager maintains a table, called the Slot Resource Table, of all 
sResources currently available in the system. 


For full details about slot card firmware, see the book "Designing Cards and 
Drivers for Macintosh II and Macintosh SE." 
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SLOT MANAGER ROUTINES 


The Slot Manager is a section of the Macintosh II ROM containing routines that 
communicate with NuBus card firmware. This section discusses them under three 
headings: 


¢ the four principal routines—those used by virtually any driver or 
application that needs to manage a NuBus card directly 

« the specialized routines—those that might be used by a driver 

¢ the advanced routines—those normally used only by the Macintosh II 
operating system 


Assembly-language note: You can invoke each of the Slot Manager routines 
with a macro of the same name preceded by an 
underscore. These macros, however, aren't trap macros 
themselves; instead they expand to invoke the trap 
macro SlotManager. The Slot Manager then determines 
the routine to execute from the routine selector, a 
long integer that's passed in register DO. The 
routine selectors are the following: 


SReadByte EQU 0 
SReadwWord EQU 1 
SReadLong EQU 2 
SGetCString EQU 3 
SGetBlock EQU 5 
SFindStruct EQU 6 
SReadStruct EQU 7 
SReadInfo EQU 16 
SReadPRAMRec EQU 17 
SPutPRAMRec EQU 18 
SReadFHeader EQU 19 
SNextRsrc EQU 20 
SNextTypesRsrc EQU 21 
SRsrcinfo EQU 22 
SCkCardStatus EQU 24 
SReadDrvrName EQU 25 
SFindDevBase EQU 27 
InitSDeclMgr EQU 32 
SPrimaryInit EQU 33 
SCardChanged EQU 34 
SExec EQU 35 
SOffsetData EQU 36 
InitPRAMRecs EQU 37 
SReadPBSize EQU 38 
SCalcStep EQU 40 
InitsRsrcTable EQU 41 
SSearchSRT EQU 42 
SUpdateSRT EQU 43 
SCalcsPointer EQU 44 
SGetDriver EQU 45 
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SPtrToSlot EQU 46 
SFindsInfoRecPtr EQU 47 
SFindsRsrcPtr EQU 48 
SdeleteSRTRec EQU 49 


At the time the trap macro is called, register AQ 
must contain a pointer to the Slot Parameter Block, 
described in the next section. On exit, the routine 
leaves a result code in register DO. 


Data Types 


The following data types are used for communication with the Slot Manager 
routines: 


Data type Description 

Byte 8 bits, signed or unsigned 

Word 16 bits, signed or unsigned 

Long 32 bits, signed or unsigned 

cString One-dimensional array of bytes, the last of which 
has the value $00 

sBlock Data structure starting with a 4-byte header 


that gives the total sBlock size 


The bit formats of the word, long, and sBlock data types are shown in Figure 1. 
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Word: 
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| 


Figure 1-Yrord, Long, and sBlock Data Types 


Figure 1-Word, Long, and sBlock Data Types 


Note: Pointers are always of type long. The value of a null 
pointer is $00000000. 


Slot Parameter Block 


Data transfer between the Slot Manager and card firmware takes place through the 
Slot Parameter Block, which has this structure: 


TYPE 
SpBlockPtr = “SpBlock; 
SpBlock = PACKED RECORD 
spResult: LONGINT; {FUNCTION result used by } 
{ every function} 
spsPointer: Ptr; {structure pointer} 
spSize: LONGINT; {size of structure} 
spOffsetData: LONGINT; {offset/data field used by } 
{ sOffsetData} 
spIOFileName: Ptr; {pointer to IOFile name used } 


{ by sDisDrvrName} 
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{pointer to sExec parameter block} 


fold Stack pointer} 

{misc field for SDM} 
{reserved for future } 

{ expansion} 

{reserved field of Slot } 

{ Resource Table} 

{RefNum} 

{sType: Category} 

{sType: Type} 

{sType:DrvrSw} 
{sType:DrvrHw} 

{type bit mask (Bits 0..3 } 
{ mask words 0..3} 

{slot number} 

{structure ID} 

{ID of the external device} 
{ID of the hardware device} 


{ByteLanes from format block } 


{ in card ROM} 
{standard flags} 
{internal use only} 


spsExecPBLlk: Ptr; 
spStackPtr: Ptr; 
spMisc: LONGINT; 
spReserved: LONGINT; 
splOReserved: INTEGER; 
spRefNum: INTEGER; 
spCategory: INTEGER; 
spCType: INTEGER; 
spDrvrSw: INTEGER; 
spDrvrHw: INTEGER; 
spTBMask: SignedByte; 
spSlot: SignedByte; 
spID: SignedByte; 
spExtDev: SignedByte; 
spHWDev: SignedByte; 
spByteLanes: SignedByte; 
spFlags: SignedByte; 
spKey: SignedByte; 
END; 


Assembly- language note: 


The Slot Parameter Block has the following structure 


in assembly language: 


spResult 
spsPointer 
spOffsetData 
spIOFileName 
spsExecBLk 
spStackPtr 
spMisc 
spReserved 
splOReserved 


spRefNum 


spCategory 
spType 
spDrvrSW 


spDrvrHW 


spTBMask 
spSlot 

spld 
spExtDev 
spHwDev 
spByteLanes 


spFlags 
spKey 
spBlockSize 


Function result (long) 

Structure pointer (long) 
Offset/Data field (long) 

Pointer to IOFileName (long) 
Pointer to sExec parameter block (long) 
Old stack pointer (long) 

Reserved for Slot Manager (long) 
Reserved (long) 

Reserved field of Slot Resource 
Table (word) 

Slot Resource Table reference 
number (word) 

sResource type: Category (word) 
sResource type: Type (word) 
sResource type: Driver software 
identifier (word) 

sResource type: Driver hardware 
identifier (word) 

Type bit mask (byte) 

Slot number (byte) 

sResource list ID (byte) 

External device identifier (byte) 
Hardware device identifier (byte) 
ByteLanes value from format block 
in card firmware (byte) 

Standard flags (byte) 

Reserved (byte) 

Size of Slot Parameter Block 
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SExec Block 


For the routine sExec, data transfer between the Slot Manager and card firmware 
also takes place through the SExec Block, which has this structure: 


SEBlockPtr = “SEBLlock; 
SEBLock = PACKED RECORD 
seSlot: SignedByte; {slot number} 
sesRsrcld: SignedByte; {sResource Id} 
seStatus: INTEGER; {status of code executed by sExec} 
seFlags: SignedByte; {flags} 
seFiller0: SignedByte; {filler--SignedByte to align } 
{ on word boundary} 
seFillerl: SignedByte; {filler} 
seFiller2: SignedByte; {filler} 
seResult: LONGINT; {result of sLoad} 
seIOFileName: LONGINT; {pointer to IOFile name} 
seDevice: SignedByte; {which device to read from} 
sePartition: SignedByte; {the partition} 
seOSType: SignedByte; {type of OS} 
seReserved: SignedByte; {reserved field} 
seRefNum: SignedByte; {RefNum of the driver} 
seNumDevices: SignedByte; {number of devices to load} 
seBootState: SignedByte; {state of StartBoot code} 
END; 


Assembly- language note: 


assembly Language: 


The SExec Block has the following structure in 


seSlot Slot number (byte) 

sesRsrclId sResource list ID (byte) 

seStatus Status of code executed by sExec (word) 
seFlags Flags (byte) 

seFillerd Filler (byte) 

seFillerl Filler (byte) 

seFiller2 Filler (byte) 

seResult Result of sLoad (long) 

selOFileName Pointer to IOFile name (long) 
seDevice Which device to read from (byte) 
sePartition Device partition (byte) 

se0SType Operating system type (byte) 
seReserved Reserved (byte) 

seRefNum RefNum of the driver (byte) 
seNumDevices Number of devices to load (byte) 
seBootState Status of the StartBoot code (byte) 


The seOSType parameter has these values: 


Name Value Description 


sMac0S68000 1 Load routine will run on a Macintosh 


computer with MC68000 processor 
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sMac0S68020 2 Load routine will run on a Macintosh 
computer with MC68020 processor 


Other values may be used for future Macintosh family operating systems. 


Principal Slot Manager Routines 


The routines described in this section are available to drivers and applications 
that need to perform slot management tasks beyond those automatically provided 
by the system. Their principal purpose is to find slot devices and open their 
drivers. 


The description of each Slot Manager routine specifies which parameters are 
required for communication with the routine. A right-pointing arrow indicates 
that the parameter is an input to the routine; a left-pointing arrow indicates 
that it is an output. Other parameters whose values may be affected by the 
routine are also listed. Parameters not mentioned remain unchanged. 


Assembly-language note: ALL Slot Manager routines return a status result in 
the low-order word of register DO after execution. A 
DO value of zero indicates successful execution. Other 
DO values are listed under "Status Results" later in 
this section. All routines report fatal errors (those 
that halt program execution); some may also report 
nonfatal errors. The description of each routine 
specifies if it can return status values indicating 
nonfatal errors. 


FUNCTION SRsrcInfo(spBlkPtr: SpBlockPtr) : OSErr; 
Trap macro: SRsrcInfo 


Required Parameters 


<-- spsPointer 
<-- splOReserved 
<-- spRefNum 
<-- spCategory 
<-- spCType 
<-- spDrvrSW 
<-- spDrvrHW 
--> spSlot 

--> spid 

--> spExtDev 
<-- spHwDev 


The trap macro SRsrcInfo returns an sResource list pointer (spsPointer), plus 
the sResource type (category, cType, software, and hardware), driver reference 
number (spRefNum), and Slot Resource Table ioReserved field (spIOReserved) for 
the sResource specified by the slot number spSlot, sResource list 
identification number spId, and external device identifier spExtDev. This call 
is most often used to return the driver reference number. 


FUNCTION SNextsRsrc(spBlkPtr: SpBlockPtr) : OSErr; 
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Trap macro: SNextsRsrc 


Required Parameters 
<-> spSlot 


<-> spld 

<-> spExtDev 

<-- spsPointer 
<-- spRefNum 

<-- splOReserved 
<-- spCategory 
<-- spCType 

<-- spDrvrSW 

<-- spDrvrHW 

<-- spHwDev 


Starting from a given slot number spSlot, sResource list identification number 
spId, and external device identifier spExtDev, the trap macro SNextsRsrc returns 
the slot number, sResource list identification number, sResource type 

(category, cType, software, and hardware), driver reference number (spRefNum), 
and Slot Resource Table ioReserved field (spIOReserved) for the next sResource. 
If there are no more sResources, SNextsRsrc returns a nonfatal error status. 
This routine can be used to determine the set of all sResources in a given slot 
card or NuBus configuration. 


FUNCTION SNextTypesRsrc(spBLkPtr: SpBlockPtr) : OSErr; 
Trap macro: SNextTypesRsrc 


Required Parameters 
<-> spSlot 


<-> spId 

<-> spExtDev 
--> spTBMask 
<-- spsPointer 
<-- spRefNum 
<-- splOReserved 
<-> spCategory 
<-> spCType 
<-> spDrvrSW 
<-> spDrvrHW 
<-> spHWwDev 


Given an sResource type (category, cType, software, and hardware) and spTBMask, 
and starting from a given slot number spSlot and sResource list identification 
number spId, the trap macro SNextTypesRsrc returns the slot number spSlot, 
sResource list identification number spId, sResource type, driver reference 
number (spRefNum), and Slot Resource Table ioReserved field (spIOReserved) for 
the next sResource of that type, as masked. If there are no more sResources of 
that type, SNextTypesRsrc returns a nonfatal error report. 


The spTBMask field lets you mask off specific fields of the sResource type that 
you don't care about, by setting any of bits 0-3. Bit 3 masks off the spCategory 
field; bit 2 the spCType field; bit 1 the spDrvrSW field; and bit 0 the spDrvrHW 
field. 
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This procedure behaves the same as sNextsRsrc except that it returns information 
only about sResources of the specified type. 


FUNCTION SReadDrvrName(spBlkPtr: SpBlockPtr) : OSErr; 
Trap macro: _SReadDrvrName 


Required Parameters 
--> spSlot 
--> spid 
--> spResult 


Other Parameters Affected 


spSize 
spsPointer 


The trap macro SReadDrvrName reads the name of the sResource corresponding to 
the slot number spSlot and sResource list identification number spId, prefixes a 
period to the value of the cString and converts its type to Str255. It then 
reads the result into a Pascal string variable declared by the calling program 
and pointed to by spResult. The final driver name is compatible with the Open 
routine. 


Specialized Slot Manager Routines 


The routines described in this section are used only by drivers. They find data 
structures in slot card firmware. 


FUNCTION SReadByte(spBlLkPtr: SpBlockPtr) : OSErr; 
Trap macro: SReadByte 


Required Parameters 


--> spsPointer 
--> splid 
<-- spResult 
Other Parameters Affected 
spOffsetData 
spByteLanes 


The trap macro SReadByte returns in spResult an 8-bit value identified by spId 
from the sResource list pointed to by spsPointer. This routine's low-order byte 
can return nonfatal error reports. 

FUNCTION SReadWord(spBlkPtr: SpBlockPtr) : OSErr; 

Trap macro: _SReadWord 


Required Parameters 
--> spsPointer 
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--> spld 


<-- spResult 
Other Parameters Affected 
spOffsetData 
spByteLanes 


The trap macro SReadWord returns in the low-order word of spResult a 16-bit 
value identified by spId from the sResource list pointed to by spsPointer. This 
routine can return nonfatal error reports. 


FUNCTION sReadLong(spBlkPtr: SpBlockPtr) : OSErr; 
Trap macro: SReadLong 


Required Parameters 
--> spsPointer 
--> spld 
<-- spResult 


Other Parameters Affected 
spOffsetData 
spByteLanes 
spSize 


The trap macro SReadLong returns in spResult a 32-bit value identified by spId 
from the sResource list pointed to by spsPointer. This routine can return 
nonfatal error reports. 


FUNCTION SGetCString(spBlkPtr: SpBlockPtr) : OSErr; 
Trap macro: SGetCString 


Required Parameters 
--> spsPointer 
--> spld 
<-- spResult 


Other Parameters Affected 
spOffsetData 
spByteLanes 
spSize 
spFlags 


The trap macro SGetCString copies a cString identified by spId from the 
sResource list pointed to by spsPointer to a buffer pointed to by spResult. 
Memory for this buffer is automatically allocated by SGetCString. 

FUNCTION SGetBlock(spBLkPtr: SpBlockPtr) : OSErr; 

Trap macro: SGetBlock 

Required Parameters 


--> spsPointer 
--> spid 
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<-- spResult 


Other Parameters Affected 
spOffsetData 
spByteLanes 
spSize 
spFlags 


The trap macro SGetBlock copies the sBlock from the sResource list pointed to by 
spsPointer and identified by spId into a new block and returns a pointer to it 
in spResult. The pointer in spResult should be disposed of by using the Memory 
Manager routine DisposPtr. 


FUNCTION SFindStruct(spBlkPtr: SpBlockPtr) : OSErr; 
Trap macro: — sFindStruct 


Required Parameters 
--> spId 
<-> spsPointer 


Other Parameters Affected 
spByteLanes 


The trap macro SFindStruct returns a pointer to the data structure defined by 
spId in the sResource list pointed to by spsPointer. 


FUNCTION SReadStruct(spBlkPtr: SpBlockPtr) : OSErr; 
Trap macro: SReadStruct 


Required Parameters 
--> spsPointer 
sa spSize 
--> spResult 


Other Parameter Affected 
spByteLanes 


The trap macro sReadStruct copies a structure of size spSize from the sResource 
list pointed to by spsPointer into a new block allocated by the calling program 
and pointed to by spResult.FUNCTION SReadInfo(spBlkPtr: SpBlockPtr) : OSErr; 


Trap macro: SReadInfo 


Required Parameters 
--> spSlot 
--> spResult 


Other Parameter Affected 
spSize 


The trap macro SReadInfo reads the sInfo record identified by spSlot into a new 
record allocated by the calling program and pointed to by spResult. Here is the 
structure of the sInfo record: 
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TYPE 


SInfoRecPtr = “SInfoRecord; 
SInfoRecord = PACKED RECORD 
siDirPtr: Ptr; {pointer to directory} 
silnitStatusA: INTEGER; {initialization error} 
silnitStatusv: INTEGER; {status returned by } 
{ vendor init code} 
siState: SignedByte; {initialization state} 
SiCPUByteLanes: SignedByte; {0@=[d0..d7], } 
{ 1l=[d8..d15], ... 
siTopOfROM: SignedByte; {top of ROM = $FSFFFFFx, } 


{ where x is TopOfROM} 
siStatusFlags: SignedByte; {bit 0--card is changed} 


siTOConstant: INTEGER; {timeout constant for } 
{ bus error} 
siReserved: SignedByte; {reserved} 
END; 


Assembly-language note: The sInfo record has the following structure 
in assembly language: 


siDirPtr Pointer to sResource directory (long) 

siInitStatusA Fundamental error (word) 

siInitStatusV Status returned by vendor init 
code (word) 

siState Initialization state—primary, 
secondary (byte) 

siCPUByteLanes Each bit set signifies a byte lane 
used (byte) 

siTopOfROM x such that Top of ROM = $FsFFFFFx 
(byte) 

siStatusFlags Bit 0 indicates if card has been 
changed (byte) 


siT0Const Timeout constant for bus error (word) 
siReserved Reserved—must be 0 (byte) 
sInfoRecSize Size of sInfo record 


The siDirPtr field of the sInfo record contains a pointer to the sResource 
directory in the configuration ROM. The siInitStatusA field indicates the 
result of efforts to initialize the card. A zero value indicates that the card 
is installed and operational. A non-zero value is the Slot Manager error code 
indicating why the card could not be used. 


The siInitStatusV field contains the value returned by the card's primary 
initialization code (in the seStatus field of the seBlock). Negative values 
cause the card to fail initialization. Zero or positive values indicate that 
the card is operational. 


The siState field is used internally to indicate what initialization steps have 
occurred so far. 


The siCPUByteLanes field indicate which byte lanes are used by the card. 
The siTopOfROM field gives the last nibble of the address of the actual 
ByteLanes value in the fHeader record. 
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The siStatusFlags field gives status information about the slot. Currently only 
the fCardIsChanged bit has meaning. A value of 1 indicates that the board ID of 
the installed card did not match the ID saved in parameter RAM—in other words, 


the card has been changed. 


The siTOConstant field contains the number of retries that will be performed 
when a bus error occurs while accessing the declaration ROM. It defaults to 
100, but may be set to another value with the TimeOut field in the board 
sResource of the card. 


The siReserved field is reserved and should have a value of 0. 
FUNCTION SReadPRAMRec(spBlkPtr: SpBlockPtr) : OSErr; 
Trap macro: _SReadPRAMRec 
Required Parameters 

--> spSlot 

--> spResult 


Other Parameter Affected 
spSize 


The trap macro SReadPRAMRec copies the sPRAM record data for the slot identified 
by spSlot to a new record allocated by the calling program and pointed to by 
spResult. 


One sPRAM record for each slot resides in the Macintosh II parameter RAM. The 
SPRAM record is initialized during startup by InitsPRAMRecs, described below 


under "Advanced Routines". Here is its structure: 
TYPE 
SPRAMRecPtr = “SPRAMRecord; 
SPRAMRecord = PACKED RECORD 
boardID: INTEGER; {Apple-defined card } 

{ identification} 
vendorUsel: SignedByte; {reserved for vendor use} 
vendorUse2: SignedByte; {reserved for vendor use} 
vendorUse3: SignedByte; {reserved for vendor use} 
vendorUse4: SignedByte; {reserved for vendor use} 
vendorUse5: SignedByte; {reserved for vendor use} 
vendorUse6: SignedByte; {reserved for vendor use} 

END; 


Assembly-language note: The sPRAM record has the following structure in 


assembly Language: 


boardID Apple-defined card indentification (word) 
vendorUsel Reserved for vendor use (byte) 
vendorUse2 Reserved for vendor use (byte) 
vendorUse3 Reserved for vendor use (byte) 
vendorUse4 Reserved for vendor use (byte) 
vendorUse5 Reserved for vendor use (byte) 
vendorUse6 Reserved for vendor use (byte) 
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If a card is removed from its slot, the corresponding sPRAM record is cleared at 
the next system startup. If a different card is plugged back into the slot, the 
corresponding sPRAM record is reinitialized. A flag is set each time an sPRAM 
record is initialized, to alert the Start Manager. 


FUNCTION SPutPRAMRec(spBlkPtr: SpBlockPtr) : OSErr; 
Trap macro: _SPutPRAMRec 


Required Parameters 
--> spSlot 
--> spsPointer 


The trap macro SPutPRAMRec copies the logical data from the block referenced by 
spsPointer into the sPRAM record for the slot identified by spSlot. This 
updates the Macintosh PRAM for that slot. The sPRAM record is defined above 
under SReadPRAMRec. In this record, the field boardId is an Apple-defined field 
and is protected during execution of SPutPRAMRec. 


FUNCTION SReadFHeader(spBlkPtr: SpBlockPtr) : OSErr; 
Trap macro: _SReadFHeader 


Required Parameters 
--> spSlot 
--> spResult 


Other Parameters Affected 
spsPointer 
spByteLanes 
spSize 
spOffsetData 


The trap macro SReadFHeader copies the format block data for the slot designated 
by spSlot to an FHeader record allocated by the calling program and pointed to 
by spResult. Here is the structure of FHeader: 


TYPE 

FHeaderRecPtr = “FHeaderRec; 

FHeaderRec = PACKED RECORD 
fhDIROffset: LONGINT; {offset to directory} 
fhLength: LONGINT; {length of ROM} 
FHCRC: LONGINT; {CRC} 
fhROMRev: SignedByte; {revision of ROM} 
fhFormat: SignedByte; {format - 2} 
fhTstPat: LONGINT; {test pattern} 


fhReserved: SignedByte; {reserved} 
fhByteLanes: SignedByte; {ByteLanes} 
END; 


Assembly-language note: The FHeader record has the following structure in 
assembly Language: 


fhDIROfFfset Offset to sResource directory (long) 
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fhLength Length of card's declaration ROM (long) 


fhCRC Declaration ROM checksum (long) 
FhROMRev ROM revision number (byte) 
fhFormat ROM format number (byte) 
fhTstPat Test Pattern (long) 


fhReserved Reserved (byte) 
fhByteLanes Byte lanes used (byte) 
fhSize Size of the FHeader record 


The fHeader record exists at the highest address of a card's declaration ROM, 
and should therefore be visible at the highest address in the card's slot space. 
The Slot Manager uses the fHeader record to verify that a card is installed in 
the slot, to determine its physical connection to NuBus (which byte lanes are 
used), and to locate the sResource directory. 


The fhDIROffset field of the fHeader record is a self-relative signed 24-bit 
offset to the sResource directory. The high order byte must be 0, or a card 
initialization error occurs. 

The fhLength field gives the size of the configuration ROM. 


The fhCRC field gives the cyclic redundancy check (CRC) value of the declaration 
ROM. The CRC value itself is taken as zero in the CRC calculation. 


The fhRomRev field gives the revision level of this declaration ROM. Values 
greater than 9 cause a card initialization error. 


The fhFormat field identifies the format of the configuration ROM. Only the 
value 1 (appleFormat ) is currently recognized as valid. 


The fhTstPat field is used to verify that the fhByteLanes field is correct. 

The fhReserved field must be zero. 

The fhByteLanes field indicates what NuBus byte lanes are used by the card. 
Byte lanes are described in the "Access to Address Space" chapter of "Designing 
Cards and Drivers for Macintosh II and Macintosh SE." 

FUNCTION SCkCardStatus(spBlkPtr: SpBlockPtr) : OSErr; 

Trap macro: SCkCardStatus 


Required Parameter 
--> spSlot 


Other Parameter Affected 
spResult 


The trap macro SCkCardStatus checks the InitStatusA field of the sInfo record of 
the slot designated by spSlot, which also reflects the value of InitStatusV. If 
this field contains a nonzero value, SCkCardStatus returns a zero value. The 
sInfo record is described above under SReadInfo. The sCkCardStatus routine can 
return nonfatal error reports. 


Trap macro: SFindDevBase 
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Required Parameters 


--> spSlot 
--> spid 
<-- spResult 


The trap macro SFindDevBase returns a pointer in spResult to the base of a 
device whose slot number is in spSlot and whose sResource id is in spId. The 
base address of a device may be in either slot or superslot space but not in 
both. Slot or superslot slot spaces are discussed in the book "Designing Cards 
and Drivers for Macintosh II and Macintosh SE." 


FUNCTION SDeleteSRTRec(spBlkPtr: SpBlockPtr) : OSErr; 
Trap macro: _SDeleteSRTRec 


Required Parameters 


--> spSlot 
--> spld 
--> spExtDev 


The trap macro SDeleteSRTRec deletes from the system's Slot Resource Table the 
sResource defined by spId,spSlot, and spExtDev. 


FUNCTION SPtrToSlot(spBlkPtr: SpBlockPtr) : OSErr; 
Trap macro: SPtrToSlot 
Required Parameters 
--> spsPointer 
<-- spSlot 
The trap macro SPtrToSlot returns in spSlot the slot number of the card whose 


declaration ROM is pointed to by spsPointer. The value of spsPointer must have 
the form Fsxx xxxx, where s is a slot number. 


Advanced Slot Manager Routines 


The routines described in this section are used only by the Macintosh II 
operating system. They are described here just for completeness of 
documentation. 


FUNCTION InitSDeclMgr(spBlkPtr: SpBlockPtr) : OSErr; 
Trap macro: _InitSDecltMgr 


The trap macro InitSDeclMgr initializes the Slot Manager. The contents of the 
parameter block are undefined. This procedure allocates the sInfo array and 
checks each slot for a card. If a card is not present, an error is logged in the 
initStatusA field of the sInfoRecord for that slot; otherwise the card's 
firmware is validated, and the resulting data is placed in the slot's 
SInfoRecord. The sInfoRecord is described above under SReadInfo. 
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FUNCTION SPrimaryInit(spBlkPtr: SpBlockPtr) : OSErr; 
Trap macro: SPrimaryInit 


Required Parameter 
--> spFlags 


The trap macro SPrimaryInit initializes each slot having an sPrimaryInit record. 
It passes the spFlags byte to the initialization code via seFlags. Within that 
byte the fWarmStart bit should be set to 1 if a warm start is being performed. 


FUNCTION SCardChanged(spBlkPtr: SpBlockPtr) : OSErr; 
Trap macro: SCardChanged 


Required Parameters 
--> spSlot 
<-- spResult 


The trap macro SCardChanged returns a value of true in spResult if the card in 
slot spSlot has been changed (that is, if its sPRAMRecord has been initialized); 
otherwise it returns false. 


FUNCTION SExec(spBlkPtr: SpBlockPtr) : OSErr; 
Trap macro: _SExec 


Required Parameters 
--> spsPointer 
--> spld 
--> spsExecPBLk 


Other parameters affected: 
spResult 


The trap macro SExec loads an sExecBlock from the sResource list pointed to by 
spsPointer and identified by spId to the current heap zone, checks its revision 
level, checks its CPU field, and executes the code. The status is returned in 
seStatus. The spsExecPBlk field is presumed to hold a pointer to an sExecBlock 
(described in the "Slot Manager Routines" section earlier in this chapter), and 
is passed to the sExec block code in register AQ. 


FUNCTION SOffsetData(spBlLkPtr: SpBlockPtr) : OSErr; 
Trap macro: SOffsetData 


Required Parameters 
--> spsPointer 
--> spld 
<-- spOffsetData 
<-- spByteLanes 


Other Parameters Affected 
spResult 
spFlags 
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The trap macro SOffsetData returns (in spOffsetData) the contents of the 
offset/data field from the sResource list identified by spId and pointed to by 
spsPointer. The parameter spsPointer returns a pointer to the fields's 
identification number in the sResource list. 

FUNCTION SReadPBSize(spBlkPtr: SpBlockPtr) : OSErr; 

Trap macro: _SReadPBSize 


Required Parameters 


--> spsPointer 
LS spld 

--> spFlags 

<-- spSize 

<-- spByteLanes 


Other Parameter Affected 
spResult 


The trap macro SReadPBSize reads the physical block size of the sBlock pointed 
to by spsPointer and identified by spId. It also checks to see that the upper 
byte is 0 if the fckReserved flag is set. The parameter spsPointer points to the 
resulting logical block when SReadPBSize is done. 

FUNCTION SCalcStep(spBlkPtr: SpBlockPtr) : OSErr; 

Trap macro: SCalcStep 


Parameters Required 


--> spsPointer 
--> spByteLanes 
--> spFlags 
<-- spResult 


The trap macro SCalcStep calculates the field sizes in the block pointed to by 
spBlkPtr. It is used for stepping through the card firmware one field at a time. 
If the fConsecBytes flag is set it calculates the step value for consecutive 
bytes; otherwise it calculates it for consecutive IDs. 


FUNCTION InitsRsrcTable(spBlkPtr: SpBlockPtr) : OSErr; 

Trap macro: InitsRsrcTable 

The trap macro InitsRsrcTable initializes the Slot Resource Table. It scans each 
slot and inserts the slot, type, sRsrcId, sRsrcPtr, and HWDevID values into the 
table for every sResource. It sets all other fields to zero. The contents of 
the parameter block are undefined. 

FUNCTION InitPRAMRecs(spBlkPtr: SpBlockPtr) : OSErr; 

Trap macro: _InitPRAMRecs 


The trap macro InitPRAMRecs scans every slot and checks its BoardId value 
against the value stored for it in its sPRAM record. If the values do not match, 
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then the CardIsChanged flag is set and the Board sResource list is searched for 
an sPRAMInitRecord. If one is found, the sPRAMRecord for the slot is initialized 
with this data; otherwise it is initialized with all zeros. 

FUNCTION SSearchSRT(spBLkPtr: SpBlockPtr) : OSErr; 

Trap macro: _SSearchSRT 


Parameters Required 


--> spSlot 

--> spId 

--> spExtDev 
--> spFlags 
--> spsPointer 


The trap macro SSearchSRT searches the Slot Resource Table for the record 
corresponding to the sResource in slot spSlot with list spId and external device 
identifier spExtDev, and returns a pointer to it in spsPointer. If the 
fckForNext bit of spFlags has a value of 0, it searches for that record; if it 
has a value of 1, it searches for the next record. 


FUNCTION SUpdateSRT(spBlLkPtr: SpBlockPtr) : OSErr; 
Trap macro: SUpdateSRT 


Parameters Required 
--> spSlot 
--> spId 
--> spExtDev 
--> spRefNum 
--> splOReserved 


Other Parameters Affected 
spsPointer 
spFlags 
spSize 
spResult 


The trap macro SUpdateSRT updates the Slot Resource Table records spRefNum and 
splOReserved with information about the sResource in slot spSlot with list spId 
and external device identifier spExtDev. This routine is called by I10Core 
whenever the driver for a slot device is opened or closed. 

FUNCTION SCalcSPtr(spBlkPtr: SpBlockPtr) : OSErr; 

Trap macro: SCalcSPtr 


Parameters Required 


--> spsPointer 
--> spOffsetData 
--> spByteLanes 


The trap macro SCalcSPtr returns a pointer to a given byte in a card's 
declaration ROM, given the pointer to a current byte and an offset 
(spOffsetData) in bytes. 
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FUNCTION SGetDriver(spBlLkPtr: SpBlockPtr) : OSErr; 
Trap macro: SGetDriver 


Parameters Required 


--> spSlot 

--> spld 

--> SpExtDev 

--> spsExecPBLk 

<-- spResult 

Other Parameters Affected 

spFlags 
spSize 


The trap macro SGetDriver loads the driver corresponding to the sResource 
designated by the slot number spSlot and the sResource list identification 
number spId into a relocatable block on the system heap and returns a handle to 
it in spResult (referenced by AO in assembly language). The driver can come from 
either of two sources: 


¢ First, the sResource sLoad directory is checked for a Macintosh 
sLoadRecord. If one is found, then the sLoad record is loaded into RAM 
and executed. 
¢ If no sLoad record exists, the sResource sDriver directory is checked for 
an sDriverRecord. If one is found, then the sDriver record is loaded into 
RAM. 
FUNCTION SFindsInfoRecPtr(spBlkPtr: SpBlockPtr) : OSErr; 
Trap macro: SFindsInfoRecPtr 
Parameters Required 
--> spSlot 
<-- spResult 


The trap macro SFindsInfoRecPtr returns a pointer to the sInfoRecord identified 
by spSlot. The sInfoRecord is described under SReadInfo. 


FUNCTION SFindsRsrcPtr(spBlkPtr: SpBlockPtr): OSErr; 
Trap macro: SFindsRsrcPtr 


Parameters Required 


<-- spsPointer 
--> spSlot 
--> spid 


Other Parameter Affected 
spResult 


The trap macro SFindsRsrcPtr returns a pointer to the sRsrc list for the sRsrc 
identified by spSlot, spID, and spExtDev. 
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Status Results 

All Slot Manager routines return a status result in register DO upon completion. 
Its value is zero if execution was successful; otherwise it is one of the values 
listed below. 

Fatal Errors 


In the event of a serious execution error (one that halts program execution), 
the Slot Manager returns one of the following status values: 


Value Name Description 

—300  smEmptySlot No card in this slot. 

-—301  smCRCFail CRC check failed. 

—302 smFormatErr The format of the card's declaration ROM is wrong. 
—303  smRevisionErr The revision of the card's declaration ROM is wrong. 
—304  smNoDir There is no sResource directory. 


—306  smNosInfoArray The SDM was unable to allocate memory for 

the sInfo array. 
—307 smResrvErr A reserved field of the declaration ROM was used. 
—308  smUnExBusErr An unexpected bus error occurred. 
—309 smBLFieldBad A valid ByteLanes field was not found. 
—312 smDisposePErr An error occurred during execution of DisposPointer. 
—313  smNoBoardsRsrc There is no board sResource. 


—314 smGetPRErr An error occurred during execution of sGetPRAMRec. 

—315  smNoBoardId There is no board Id. 

—316 smInitStatVErr The InitStatus V field was negative after Primary Init. 

—317 = smInitTbleErr An error occurred while trying to initialize the 
sResource Table. 

—318 = smNoJmpTbl Slot Manager jump table could not be created. 


—319 smBadBoardiId BoardId was wrong; reinit the PRAM record. 
Nonfatal Errors 


Some (but not all) of the Slot Manager routines may also indicate nonfatal 
execution problems by returning one of the status values listed below. The 
discussion of each routine earlier in this chapter indicates whether or not it 
can return a nonfatal error. 


Value Name Description 

—330  smBadRefiId Reference ID was not found in the given sResource List. 

—331  smBadsList The IDs in the given sResource list are not in 
ascending order. 

—332 smReservedErr A reserved field was not zero. 

—333  smCodeRevErr The revision of the code to be executed by sExec 
was wrong. 

—334 |= smCPUErr The CPU field of the code to be executed by sExec 
was wrong. 

—335  smsPointerNil The sPointer is NIL. No sResource list is specified. 

—336 smNilsBlockErr The physical block size (of an sBlock) was zero. 

—337 smSlotOOBErr The given slot was out of bounds (or does not exist). 
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—338 
—339 
-341 
—342 
—344 
—345 
—346 
—347 
—350 
-351 


smSeLOOBErr Selector is out of bounds. 

smNewPErr An error occurred during execution of NewPointer. 
smCkStatusErr Status of slot is bad (InitStatus A,V). 
smGetDrvrNamErr An error occurred during execution of sGetDrvrName. 
smNoMoresRsrcs No more sResources. 


smGetDrvrErr An error occurred during execution of sGetDrvr. 
smBadsPtrErr A bad sPointer was presented to a SDM call. 
smByteLanesErr Bad ByteLanes value was passed to an SDM call. 
smSRTOvrFlErr Slot Resource Table overflow. 

smRecNotFnd Record not found in the Slot Resource Table. 
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SUMMARY OF THE SLOT MANAGER 


Constants 
CONST 


{ seOSType parameter values } 


sMac0S68000 =1 {driver will run with 68000 processor} 
sMac0S68020 = 2 {driver will run with 68020 processor} 
Data Types 
TYPE 
SpBlockPtr = “SpBlock; 
SpBlock = PACKED RECORD 
spResult: LONGINT; {FUNCTION result used by } 


{ every function} 


spsPointer: Ptr; {structure pointer} 
spSize: LONGINT; {size of structure} 
spOffsetData: LONGINT; {offset/data field used by } 
{ sOffsetData} 
splOFileName: Ptr; {pointer to IOFile name used } 
{ by sDisDrvrName} 
spsExecPBLk: Ptr; {pointer to sExec parameter block} 
spStackPtr: Ptr; {old Stack pointer} 
spMisc: LONGINT; {misc field for SDM} 
spReserved: LONGINT; {reserved for future } 
{ expansion} 
splOReserved: INTEGER; {reserved field of Slot } 
{ Resource Table} 
spRefNum: INTEGER; {RefNum} 
spCategory: INTEGER; {sType: Category} 
spCType: INTEGER; {sType: Type} 
spDrvrSw: INTEGER; {sType:DrvrSw} 
spDrvrHw: INTEGER; {sType:DrvrHw} 
spTBMask: SignedByte; {type bit mask (Bits 0..3 } 
{ mask words 0..3} 
spSlot: SignedByte; {slot number} 
spID: SignedByte; {structure ID} 
spExtDev: SignedByte; {ID of the external device} 
spHwDev: SignedByte; {ID of the hardware device} 
spByteLanes: SignedByte; {ByteLanes from format block } 
{ in card ROM} 
spFlags: SignedByte; {standard flags} 
spKey: SignedByte; {internal use only} 
END; 


SInfoRecPtr = *SInfoRecord; 
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SInfoRecord = PACKED RECORD 
siDirPtr: 
siInitStatusA 
siInitStatusV 


siState: 
siCPUByteLane 


SiTopOfROM: 


siStatusFlags 
siTOConstant: 


siReserved: 
END; 


SEBlockPtr 
SEBLlock 


“SEBLock; 

PACKED RECORD 
seSlot: 
sesRsrcld: 
seStatus: 
seFlags: 
seFillero: 


seFillerl: 
seFiller2: 
seResult: 
selOFileName: 
seDevice: 
sePartition: 
seOSType: 
seReserved: 
seRefNum: 
seNumDevices: 
seBootState: 
END; 


SPRAMRecPtr 
SPRAMRecord 


“SPRAMRecord; 
PACKED RECORD 
boardID: 


vendorUsel: 

vendorUse2: 

vendorUse3: 

vendorUse4: 

vendoruUse5: 

vendorUse6: 
END; 


FHeaderRecPtr 
FHeaderRec 


“FHeaderRec; 

PACKED RECORD 
fhDIROffset 
fhLength: 
fhCRC: 
fhROMRev: 


Ptr; 
p INTEGER; 
: INTEGER; 


SignedByte; 
Ss: SignedByte; 


SignedByte; 


: SignedByte; 


INTEGER; 


SignedByte; 


SignedByte; 
SignedByte; 
INTEGER; 

SignedByte; 
SignedByte; 


SignedByte; 
SignedByte; 
LONGINT; 

LONGINT; 

SignedByte; 
SignedByte; 
SignedByte; 
SignedByte; 
SignedByte; 
SignedByte; 
SignedByte; 


INTEGER; 


SignedByte; 
SignedByte; 
SignedByte; 
SignedByte; 
SignedByte; 
SignedByte; 


: LONGINT; 
LONGINT; 
LONGINT; 
SignedByte; 


{pointer to directory} 
{initialization error} 
{status returned by } 

{ vendor init code} 
{initialization state} 
{0=[d0..d7], } 

{ l=[d8..d15], ... 

{top of ROM = $FsFFFFFx, } 
{ where x is TopOfROM} 
{bit 0--card is changed} 
{timeout constant for } 
{ bus error} 

{reserved} 


{slot number} 

{sResource Id} 

{status of code executed by sExec} 
{flags} 

{filler--SignedByte to align } 
{ on word boundary} 

{filler} 

{filler} 

{result of sLoad} 

{pointer to IOFile name} 
{which device to read from} 
{the partition} 

{type of 0S} 

{reserved field} 

{RefNum of the driver} 

{number of devices to load} 
{state of StartBoot code} 


{Apple-defined card } 
{ identification} 

{reserved for vendor 
{reserved for vendor 
{reserved for vendor 
{reserved for vendor 
{reserved for vendor 
{reserved for vendor 


use} 
use} 
use} 
use} 
use} 
use} 


{offset to directory} 
{length of ROM} 

{CRC} 

{revision of ROM} 
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fhFormat: SignedByte; {format - 2} 
fhTstPat: LONGINT; {test pattern} 
fhReserved: SignedByte; {reserved} 
fhByteLanes: SignedByte; {ByteLanes} 
END; 
Routines 
Principal Routines 
FUNCTION SRsrcInfo (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SNextsRsrc (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SNextTypesRsrc (spBlkPtr: SpBlockPtr) : OSErr; 
FUNCTION SReadDrvrName (spBLkPtr: SpBlockPtr) : OSErr; 
Specialized Routines 
FUNCTION SReadByte (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SReadWord (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SReadLong (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SGetcString (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SGetBlock (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SFindStruct (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SReadStruct (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SReadInfo (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SReadPRAMRec (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SPutPRAMRec (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SReadFHeader (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SCkCardStatus (spBlkPtr: SpBlockPtr) : OSErr; 
FUNCTION SFindDevBase (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SDeleteSRTRec 
FUNCTION SPtrToSlot (spBLkPtr: SpBlockPtr) : OSErr; 
Advanced Routines 
FUNCTION InitSDeclMgr (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SPrimaryInit (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SCardChanged (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SExec (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SOffsetData (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SReadPBSize (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SCalcStep (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION InitsRsrcTable (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION InitPRAMRecs (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SSearchSRT (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SUpdateSRT (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SCalcSPointer 
FUNCTION SGetDriver (spBLkPtr: SpBlockPtr) : OSErr; 
FUNCTION SFindSInfoRecPtr 
FUNCTION SFindSRsrcPtr 
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Assembly-Language Information 
Constants 


; Routine selectors for StotManager trap 


sReadByte EQU 0 
sReadWord EQU 1 
sReadLong EQU 2 
sGetcString EQU 3 
sGetBlock EQU 5 
sFindStruct EQU 6 
sReadStruct EQU 7 
sReadInfo EQU 16 
sReadPRAMRec EQU 17 
sPutPRAMRec EQU 18 
sReadFHeader EQU 19 
sNextRsrc EQU 20 
sNextTypesRsrc EQU 21 
sRsrcinfo EQU 22 
sDisposePtr EQU 23 
sCkCardStatus EQU 24 
sReadDrvrName EQU 25 
sFindDevBase EQU 27 
InitSDeclMgr EQU 32 
sPrimaryInit EQU 33 
sCardChanged EQU 34 
sExec EQU 35 
sOffsetData EQU 36 
InitPRAMRecs EQU 37 
sReadPBSize EQU 38 
sCalcStep EQU 40 
InitsRsrcTable EQU 41 
sSearchSRT EQU 42 
sUpdateSRT EQU 43 
sCalcsPointer EQU 44 
sGetDriver EQU 45 
sPtrToSlot EQU 46 
sFindsInfoRecPtr EQU 47 
sFindsRsrcPtr EQU 48 
sdeleteSRTRec EQU 49 


Slot Parameter Block Structure 


spResult Function result (long) 
spsPointer Structure pointer (long) 
spOffsetData Offset/Data field (long) 
splOFileName Pointer to IOFileName (long) 


spsExecBlk Pointer to sExec parameter block (long) 
spStackPtr Old stack pointer (long) 

spMisc Reserved for Slot Manager (long) 

spReserved Reserved (long) 

splOReserved Reserved field of Slot Resource Table (word) 
spRefNum Slot Resource Table reference number (word) 
spCategory sResource type: Category (word) 
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splype sResource type: Type (word) 


spDrvrSW sResource type: Driver software identifier (word) 
spDrvrHW sResource type: Driver hardware identifier (word) 
spTBMask Type bit mask (byte) 

spSlot Slot number (byte) 

spid sResource list ID (byte) 

spExtDev External device identifier (byte) 

spHwDev Hardware device identifier (byte) 

spByteLanes ByteLanes value from format block in card firmware (byte) 
spFlags Standard flags (byte) 

spKey Reserved (byte) 


spBlockSize Size of Slot Parameter Block 


Slot Executive Block Structure 


seSlot Stot number (byte) 

sesRsrclId sResource list ID (byte) 
seStatus Status of code executed by sExec (word) 
seFlags Flags (byte) 

seFillerd Filler (byte) 

seFillerl Filler (byte) 

seFiller2 Filler (byte) 

seResult Result of sLoad (long) 
selOFileName Pointer to IOFile name (long) 
seDevice Which device to read from (byte) 
sePartition Device partition (byte) 

se0SType Operating system type (byte) 
seReserved Reserved (byte) 

seRefNum RefNum of the driver (byte) 


seNumDevices Number of devices to load (byte) 
seBootState Status of the StartBoot code (byte) 


SInfo Record Structure 
siDirPtr Pointer to sResource directory (long) 


silInitStatusA Fundamental error (word) 
SiInitStatusV Status returned by vendor init code (word) 


siState Initialization state—primary, secondary (byte) 
SiCPUByteLanes Each bit set signifies a byte lane used (byte) 
SiTopOfROM Top of ROM = $FssFFFFx, where x is siTopOfROM (byte) 
siStatusFlags Bit 0 indicates if card has been changed (byte) 
siTOConst Timeout constant for bus error (word) 

siReserved Reserved—must be 0 (byte) 

sInfoRecSize Size of sInfo record 


FHeader Record Structure 


fhDIROfFfset Offset to sResource directory (long) 


fhLength Length of card's declaration ROM (long) 
fhCRC Declaration ROM checksum (long) 
FhROMRev ROM revision number (byte) 

fhFormat ROM format number (byte) 

fhTstPat Test Pattern (long) 


fhReserved Reserved (byte) 
fhByteLanes Byte lanes used (byte) 
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fhSize Size of the FHeader record 
SPRAM Record Structure 


boardID Apple-defined card indentification (word) 
vendorUsel Reserved for vendor use (byte) 

vendorUse2 Reserved for vendor use ( 
vendorUse3 Reserved for vendor use ( 
vendorUse4 Reserved for vendor use (byte) 
vendorUse5 Reserved for vendor use ( 
vendorUse6 Reserved for vendor use ( 


Trap Macro Name 


_SlotManager 
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Further Reference: 


Device Manager 

32-Bit QuickDraw Documentation 

"Macintosh Family Hardware Reference" 

"Designing Cards and Drivers for the Macintosh II and Macintosh SE" 


END OF DOCUMENT 
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